Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Managing Your Panel's Settings

SGPanelSetSettings

Sequence grabber components call your component's SGPanelSetSettings function in order to restore your panel's current settings.

pascal ComponentResult SGPanelSetSettings 
                                 (SeqGrabPanelComponent s,
                                  SGChannel c, UserData ud, 
                                  long flags);

s

Identifies the sequence grabber component's connection to your panel component.

c

Identifies a connection to the sequence grabber channel associated with your panel component.

ud

Identifies a user data item that contains new settings information for your panel. Your component must not dispose of this user data item.

flags

Reserved for future use.

DESCRIPTION

A sequence grabber component calls your SGPanelSetSettings function in order to restore your panel's settings. The sequence grabber may call this function when the user cancels the settings dialog box.

Your component originally creates the settings information when the sequence grabber calls your SGPanelGetSettings function (described in the previous section). The sequence grabber passes this configuration information back to you in the ud parameter to this function. Your component should parse the configuration information and use
it to establish your panel's current settings.

Note that your component may not be able to accommodate the original settings. For example, because the settings may have been stored for some time, the hardware environment may not be able to support the values in the settings. You should try to make your new settings match the original settings as closely as possible. If you cannot get close enough, return an appropriate sequence grabber or sequence grabber channel result code.

You may use Movie Toolbox functions to manipulate the user data item (see the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for more information about functions that work with user data items).

RESULT CODES

noDeviceForChannel

-9408

Device cannot support settings

Other appropriate sequence grabber or sequence grabber channel result codes

SEE ALSO

Sequence grabber components use your component's SGPanelGetSettings function (described in the previous section) to retrieve the configuration information.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help